configure mirror add

configure mirror { mirror_name} add [ {vlan} vlan_name | vlan vlan_id] {ingress | [port port {ingress}}| ip-fix | port port vlan [vlan_id | vlan_name ] {ingress}]

Description

Specifies mirror source filters for an instance.

Syntax Description

mirror_name Specifies the mirror's name.
vlan Specifies a VLAN.
vlan_id Specifies a VLAN ID.
port Specifies a port or slot and port.
port Specifies particular ports or slots and ports.
ingress Specifies packets be mirrored as they are received on a port.
Note: This parameter is available only with port-based mirroring.
ip-fix Enables mirroring of the first fifteen packets of every IPFIX flow.
egress Specifies packets be mirrored as they are sent from a port.
Note: This parameter is available only with port-based mirroring.
ingress-and-egress Specifies all forwarded packets be mirrored. This is the default for port-based mirroring.
Note: This parameter is available only with port-based mirroring.

Default

N/A.

Usage Guidelines

You must enable port-mirroring using the enable mirroring to port command before you can configure the mirroring filter definitions.

Port mirroring configures the switch to copy all traffic associated with one or more ports to a monitor port on the switch. The switch uses a traffic filter that copies a group of traffic to the monitor port.

Up to 128 mirroring filters can be configured with the restriction that a maximum of 16 of these can be configured as VLAN and/or virtual port (port + VLAN) filters.

One monitor port or 1 monitor port list can be configured. A monitor port list may contain up to 16 ports.

Frames that contain errors are not mirrored.

For general guideline information and information for various platforms, see “Guidelines for Mirroring” in the Switch Engine v33.1.1 User Guide or the Usage Guidelines of the enable mirroring to port command.

Example

The following example sends all traffic coming into a switch on port 11 and the VLAN default to the mirror port:

configure mirror add port 11 vlan default

History

This command was first available in ExtremeXOS 15.3.

The vlan_id option was added in ExtremeXOS 16.1.

The ip-fix option was added in ExtremeXOS 21.1.

Platform Availability

This command is available on all Universal switches supported in this document.